home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #1 / Ham Radio 2000.iso / ham2000 / tcp_ip / docs / cmdshlp8 / route < prev    next >
Encoding:
Text File  |  1995-12-10  |  5.1 KB  |  125 lines
  1.  
  2. route [<subcommand>]
  3.  
  4.      With no arguments, 'route' displays the IP routing table.
  5.      
  6.  
  7.     route add <desthostid>[/bits] | default  <iface> [<gatewayhostid> |
  8.     direct] [<metric>]
  9.  
  10.      NOTE:  Attempting tcp connections to an address without an
  11.      existing route fails immediately.
  12.      
  13.      This command adds an entry to the routing table.  It requires at
  14.      least two more arguments, the desthostid of the target
  15.      destination and the name of the interface <iface> to which its
  16.      packets should be sent.  If the destination is not local,  the
  17.      gateway's hostid should also be specified. (If the interface is a
  18.      point-to-point link, then <gatewayhostid> may be omitted even if
  19.      the target is non-local because this field is only used to
  20.      determine the gateway's link level address, if any.  If the
  21.      destination is directly reachable, <gatewayhostid> is also
  22.      unnecessary since the destination address is used to determine
  23.      the interface link address).  If <rspf> is used and the system is
  24.      a switch / router to multiple routes, the keyword 'direct' can be
  25.      used instead of a <gatewayhostid> to set the metric higher than
  26.      the default of 1.  This way routes advertised by other rspf
  27.      stations can be cheaper and get selected.  If 'direct' is given
  28.      but <metric> not, an new algorithm is used to set the metric
  29.      dependent on the number of subnet mask bits.
  30.      The optional /bits suffix to the destination host id specifies
  31.      how many leading bits in the host id are to be considered
  32.      significant in the routing comparisons.  If not specified, 32
  33.      bits (i.e., full significance) is assumed. With this option, a
  34.      single routing table entry may refer to many hosts all sharing a
  35.      common bit string prefix in their IP addresses.  For example,
  36.      ARPA Class A, B and C networks would use suffixes of /8,  /16 and
  37.      /24 respectively. E.g. the command
  38.  
  39.                route add 44/8 ax0 44.64.0.2
  40.      
  41.      causes any IP addresses beginning with "44" in the first 8 bits
  42.      to be routed to 44.64.0.2; the remaining 24 bits are "don't-
  43.      cares".
  44.      
  45.      When an IP address to be routed matches more than one entry in
  46.      the routing table, the entry with largest 'bits' parameter (i.e.,
  47.      the "best" match) is used. This allows individual hosts or blocks
  48.      of hosts to be exceptions to a more general rule for a larger
  49.      block of hosts.
  50.      
  51.      The special destination 'default' is used to route datagrams to
  52.      addresses not matched by any other entries in the routing table;
  53.      it is equivalent to specifying a /bits suffix of /0 to any
  54.      destination hostid. Care must be taken with 'default' entries
  55.      since two nodes with default entries pointing at each other will
  56.      route packets to unknown addresses back and forth in a loop until
  57.      their  time-to-live (TTL) fields expire.  (Routing loops for
  58.      specific addresses can also be created, but this is less likely
  59.      to occur accidentally).
  60.      
  61.      There is one built-in interface: loopback. Loopback is for
  62.      internal purposes only.
  63.      
  64.      Here are some examples of the route command:
  65.           
  66.      # Route datagrams to IP address 44.0.0.3 to SLIP line #0.
  67.      # No gateway is needed because SLIP is point-to point.
  68.      
  69.      route add 44.0.0.3 sl0
  70.      
  71.      # Route all default traffic to the gateway on the local Ethernet
  72.      # with IP address 44.0.0.1
  73.      
  74.      route add default ec0 44.0.0.1
  75.      
  76.      # The local Ethernet has an ARPA Class-C address assignment;
  77.      # route all IP addresses beginning with 192.4.8 to it
  78.      
  79.      route add 192.4.8/24 ec0
  80.      
  81.      # The station with IP address 44.0.0.10 is on the local AX.25
  82.      channel
  83.      
  84.      route add 44.0.0.10 ax0
  85.      
  86.      #An encapsulation link to 192.4.8.12 where the subnet 44.64.0.0
  87.      is accessible. The Internet does not know
  88.       #where we are but we just use them with what they know:
  89.      route add 44.64.0.0/16 encap 192.4.8.12 4
  90.           
  91.  
  92.     route addprivate <dest hostid>[/bits] | default  <iface>
  93.     [<gateway hostid> [<metric>]]
  94.  
  95.      This command is identical to 'route add' except that  it  also
  96.      marks  the  new entry as private; it will never be included in
  97.      outgoing RIP updates. It will also not be shown in the nodeshell
  98.      'IProute' command.
  99.  
  100.  
  101.     route drop <dest hostid>[/bits]
  102.  
  103.      Delete an entry from the table.  If  a  packet  arrives  for  the
  104.      deleted address and a default route is in effect, it will be
  105.      used.
  106.  
  107.  
  108.     route flush
  109.  
  110.      Delete (drop) all temporary routes, that is, routes added with an
  111.      expiration timer (eg, by RIP).
  112.  
  113.  
  114.     route look <hostname>
  115.  
  116.      Display just the routing table entry used to reach <hostname>.
  117.  
  118.      
  119.     route sort [off|ON]
  120.  
  121.      Display or set the route display sort flag.  When set, the route
  122.      command will sort its report, which tends to display similar routes
  123.      together.  When reset, the report is by decreasing number of
  124.      significant bits used in comparing host addresses.
  125.